home *** CD-ROM | disk | FTP | other *** search
/ Almathera Ten Pack 3: CDPD 3 / Almathera Ten on Ten - Disc 3: CDPD3.iso / scope / 126-150 / scopedisk148 / powerplatform / docs / powerplatform10.doc < prev    next >
Text File  |  1995-03-19  |  78KB  |  1,676 lines
  1.      
  2.  
  3.  
  4.                                  PowerPlatform
  5.  
  6.  
  7.                                   User's Guide
  8.  
  9.  
  10.  
  11.  
  12.  
  13.                                   Release 1.0
  14.  
  15.  
  16.                                   August 1990
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.                        Copyright © 1990 Martin C. Warnett
  61.  
  62.  
  63.                                PowerPlatform 1.0                     Page 2
  64.  
  65.  
  66.      __II__nn__tt__rr__oo__dd__uu__cc__tt__ii__oo__nn 
  67.  
  68.           At first  glance  PowerPlatform  may  appear  to  be just another
  69.      directory  utility program. Typically a directory utility program will
  70.      have  one or more directory windows and a bunch of gadgets to help you
  71.      move  around  the  directory  tree.  It  would  also  have an array of
  72.      function  buttons  that  enable  you to do such things as copy, delete
  73.      and rename files. PowerPlatform has all these features.  
  74.  
  75.           Typically a  directory  utility  will  give  you  the  ability to
  76.      define  some  of these function buttons yourself. For example it might
  77.      allow  you  to change the Edit function button to invoke the editor of
  78.      your choice. PowerPlatform has this feature too.  
  79.  
  80.           But typically  directory  utilities  don't  give you control over
  81.      much  else.  PowerPlatform  does.  PowerPlatform has only two built in
  82.      functions.  For  example it does not have it's own copy function. This
  83.      may  seem  strange  at  first  but  using an ARexx EXEC you define the
  84.      PowerPlatform  functions.  You define the name of the button, where it
  85.      goes  on the screen and more importantly what it does. You can run any
  86.      AmigaDOS  command,  CLI  program, WorkBench program or ARexx EXEC from
  87.      within PowerPlatform.  
  88.  
  89.           The default  PowerPlatform ARexx configuration EXEC, (referred to
  90.      as  the  profile),  simply  defines  the  Copy  function  as using the
  91.      AmigaDOS  copy  command,  after  all  a copy function is simply a copy
  92.      function,  right?  Not  necessarily.  For  example,  I  have seen many
  93.      debates  rage  on  bulletin boards and online networks over whether or
  94.      not  the  copy  command should copy the original file's creation date.
  95.      The  AmigaDOS  copy  command  allows  you  to create the new file with
  96.      either  the  current  date or the original date. Because PowerPlatform
  97.      allows  you to specify the actual command used to copy a file, you can
  98.      do  it  which  ever  way  you want. If you would prefer to use another
  99.      copy  utility,  maybe  the  ARP  copy command, go ahead. Do you need a
  100.      function  that  AmigaDOS does not provide, say a move command? Use you
  101.      favorite  move utility from within PowerPlatform. Don't have one? Then
  102.      build  your  own  using ARexx. The full power of ARexx is available to
  103.      you from within PowerPlatform.  
  104.  
  105.           Maybe you   would   like   to   launch  your  favorite  WorkBench
  106.      applications  from  within  PowerPlatform.  No problem! You can easily
  107.      add  them  to  the  PowerPlatform  menu  bar  where they are instantly
  108.      available.  No  more  digging  through directories trying to find that
  109.      paint program or game.  
  110.  
  111.           The "Power"  in  PowerPlatform actually comes from the ability to
  112.      configure  the  way  it  works  using ARexx. This gives you tremendous
  113.      power  to  create  your  own custom environment. However it also means
  114.      that  PowerPlatform  does  not  run  "off  the  shelf".  Unlike  other
  115.      products  you  will  have  to  read  this  manual  to  effectively use
  116.      PowerPlatform.  You  will  also  have to take the time to customize it
  117.      and  develop  your  own  ARexx  EXEC's  to take full advantage of it's
  118.      power.   Take   the  time  to  read  this  manual  and  fully  explore
  119.      PowerPlatform's features.  
  120.  
  121.           I would   very  much  like  to  hear  your  comments  about  both
  122.      PowerPlatform and this manual. You can contact me as follows: 
  123.  
  124.  
  125.                                PowerPlatform 1.0                     Page 3
  126.  
  127.  
  128.                Martin C. Warnett.  
  129.                2407 25th Avenue 
  130.                San Francisco 
  131.                CA 94116 
  132.  
  133.                BIX:        mwarnett 
  134.                Compuserve: 70431,3565 
  135.  
  136.  
  137.  
  138.           Please remember  that PowerPlatform is shareware. If you continue
  139.      to  use the product beyond the 30 day trial period please register it.
  140.      Full  instructions  on  how  to register PowerPlatform can be found at
  141.      the  end  of  this  manual.  Please  feel free to pass this version of
  142.      PowerPlatform  on  to  your  friends  and  favorite  bulletin  boards.
  143.      However  please  only  distribute  the  entire  package exactly as you
  144.      received it.  
  145.  
  146.           I hope  you find PowerPlatform useful. Please report any problems
  147.      you  encounter  or  any  ideas  you have for future enhancements to me
  148.      either by email or regular mail.  
  149.  
  150.  
  151.  
  152.      __PP__oo__ww__ee__rr__PP__ll__aa__tt__ff__oo__rr__mm____II__nn__ss__tt__aa__ll__ll__aa__tt__ii__oo__nn 
  153.  
  154.           Before you   install  PowerPlatform,  make  sure  that  you  have
  155.      installed  ARexx  on  your  system.  ARexx  must be running before you
  156.      start  PowerPlatform.   You may want to consider putting ARexx in your
  157.      startup-sequence  if  it is not already there. For more information on
  158.      installing ARexx, consult the documentation that came with it.  
  159.  
  160.           Installation of  PowerPlatform  is  very  simple,  just  copy the
  161.      PowerPlatform  and  PowerPlatform.info  files to the directory of your
  162.      choice.  Copy the PowerPlatform EXEC's, the files that end in .APP, to
  163.      your   REXX:   directory.   You  can  start  PowerPlatform  from  your
  164.      Startup-Sequence  if  you  like.  PowerPlatform will detach itself and
  165.      allow  the  startup  shell  to  close.   PowerPlatform  needs only the
  166.      standard 4000 byte stack.  
  167.  
  168.           A special  note  for  AmigaDOS 2.0 users, you might want to leave
  169.      PowerPlatform  out  on  your  WorkBench  so  that  it  will  always be
  170.      available.   Just simply select the PowerPlatform icon and then select
  171.      the leave out item from the Icons menu.  
  172.  
  173.           Before running  PowerPlatform edit the Profile.APP file which you
  174.      should  have  copied  to your REXX: directory. PowerPlatform looks for
  175.      this  file  when it starts up and uses it to set up your PowerPlatform
  176.      configuration.  The  version of Profile.APP shipped with PowerPlatform
  177.      is   fairly   generic  and  should  run  on  most  systems.  You  will
  178.      undoubtedly  be  changing the profile as you become more familiar with
  179.      the  program.  Remember  that the profile is an ARexx EXEC so it helps
  180.      if  you  are  familiar  with ARexx syntax.  For now just quickly check
  181.      through the following.  
  182.  
  183.           The first  section  of the file defines the devices PowerPlatform
  184.      will  use.   These  devices will normally include all your disks, Hard
  185.  
  186.  
  187.                                PowerPlatform 1.0                     Page 4
  188.  
  189.  
  190.      disks,  floppy  disks and RAM disks. Remove any devices not present on
  191.      your  system, and if you like add new ones. Full information on how to
  192.      do  this can be found in the command reference section of this manual.
  193.      However  the  syntax should be fairly obvious from the examples in the
  194.      profile.  
  195.  
  196.           The menu  bar  definitions  come  next.  For now you can probably
  197.      leave  these  as  they  are.  The  final section contains the function
  198.      button  definitions.   Take  a  look  at  the  definition for the edit
  199.      function.  It  is  probably  a  good idea to change it now to use your
  200.      favorite editor.  
  201.  
  202.           This should  be enough to get you up and running. Now you can use
  203.      PowerPlatform  itself to continue the customization process. Please be
  204.      sure  to read the configuration section of this manual before you make
  205.      any further changes to your profile.  
  206.  
  207.           It is  possible  that you might experience some problems with the
  208.      standard  profile because you may have removed some of the programs it
  209.      references  from  your  system  or  you  may  not  have  the  required
  210.      directories  on  your  path.   You  will  also find references to some
  211.      commercial  programs  you may not have purchased. Please remember that
  212.      this  is  just  a sample profile designed to get you up and running as
  213.      quickly  as possible. The customization process is discussed in detail
  214.      later in this manual.  
  215.  
  216.  
  217.  
  218.      __UU__ss__ii__nn__gg____PP__oo__ww__ee__rr__PP__ll__aa__tt__ff__oo__rr__mm 
  219.  
  220.           When PowerPlatform  starts up it opens up a window, by default on
  221.      your  WorkBench,  but  you  can  also  get  PowerPlatform to open it's
  222.      window  on a custom hires or interlaced screen.  The directory area is
  223.      on  the  left  side  of  the window, the function area is on the right
  224.      side  and  the  disk  information  area is at the bottom. Lets look at
  225.      each  of  these areas as well as the PowerPlatform menu bar. First the
  226.      directory and function areas.  
  227.  
  228.  
  229.      TThhee PPoowweerrPPllaattffoorrmm DDiirreeccttoorryy aanndd FFuunnccttiioonn AArreeaass 
  230.  
  231.           The following  explanation  is  going to make a lot more sense if
  232.      you  have  PowerPlatform  running  as  you  read  it.  If you have not
  233.      already  done  so  start PowerPlatform by double clicking on it's icon
  234.      or  by  typing  PowerPlatform  on  the  command  line.  You can invoke
  235.      PowerPlatform from either the WorkBench or the command line.  
  236.  
  237.           On the  left  side  of the directory area are the device gadgets.
  238.      As  you  saw  in  the  previous section of this manual, you define the
  239.      actual  devices in your profile. Clicking on one of the device gadgets
  240.      makes  the  selected  device  the active device. The root directory of
  241.      that device will be displayed.  
  242.  
  243.           PowerPlatform maintains  two  directories,  the  source directory
  244.      and  the  target directory. Only one of these directories is displayed
  245.      at  a time. The area title clearly indicates which one.  The directory
  246.      display  itself  lists  all  files  and  subdirectories in the current
  247.  
  248.  
  249.                                PowerPlatform 1.0                     Page 5
  250.  
  251.  
  252.      directory.  You  can  identify  which  directory entries are files and
  253.      which  are  subdirectories  by  the  color.  By  default PowerPlatform
  254.      displays  the  size  of  each  file  in bytes to the right of the file
  255.      name.  You  can  select  to display the file size in blocks instead or
  256.      display   the   creation   date   or   time.  Only  the  name  of  the
  257.      subdirectories are displayed.  
  258.  
  259.           You can  switch  between  the  two directories by clicking in the
  260.      S<>T  gadget.   You  can  refresh  the  current  directory  display by
  261.      clicking  on  the  directory  title  gadget,  i.e.  "Source  Directory
  262.      Window".   You  can  go  down  the  directory  tree  by  simply double
  263.      clicking  on  any  of the subdirectories displayed.  You can move back
  264.      up  to  the  parent directory by clicking on the PAR< gadget.  You can
  265.      move back up to the root directory by clicking on the device gadget.  
  266.  
  267.           Hopefully all  the  above  is  fairly  obvious  and with a little
  268.      practice  should  become  very  easy  to master. There are a couple of
  269.      other  gadgets  that  may  need  a  little  more  explanation.  If you
  270.      currently  have  the  source  directory  displayed  you  will  see two
  271.      gadgets,  one  marked  <T  and  the  other  marked  >T.  If the target
  272.      directory  is  displayed  they will be <S and >S.  These gadgets are a
  273.      quick  way of making the source directory and the target directory the
  274.      same.  The  following  assumes  that the source directory is currently
  275.      displayed.   By  clicking  on >T, the Target directory is now the same
  276.      as  the  source  directory. By clicking on <T, the source directory is
  277.      the  same  as  the  target  directory. The current target directory is
  278.      always  displayed  in  a  string gadget at the bottom of the directory
  279.      area.  
  280.  
  281.           The three  arrows  at the top left of the directory area are used
  282.      to  manipulate  the  directory  stack. You can always push the current
  283.      directory  onto the stack and pull it off at any time. Click on the up
  284.      button  to  push  the  current  directory  onto the stack. Now move to
  285.      another  directory  and click on the down button to pull the directory
  286.      off  of  the  stack.  You should be back where you started from. Go to
  287.      another  directory  and  click  on  the  two headed arrow. The current
  288.      directory  and  the  stack  directory  are exchanged. Keep clicking on
  289.      this  gadget  to  alternate between the two directories. The directory
  290.      stack  is  only  one level deep, i.e. as you push a new directory onto
  291.      the  stack  the  old  value  of the stack is lost, however pulling the
  292.      directory  off  of  the stack does not remove it from the stack. There
  293.      are separate source and target directory stacks.  
  294.  
  295.           Directory entries,  (files  and  subdirectories), are selected by
  296.      simply  clicking  on  them.  When you select an entry the color of the
  297.      text   and   background  switch.  For  example  if  you  have  set  up
  298.      PowerPlatform  so  that the background is white and the text is black,
  299.      the  background  of  the  selected entry becomes black and the name is
  300.      displayed  in  white.  If you select an entry in error simply click on
  301.      it again to deselect it.  
  302.  
  303.           If you  double  click  on a directory entry one of several things
  304.      could  happen.  If you double click on a subdirectory you will go into
  305.      that  subdirectory  and it's contents will be displayed. If you double
  306.      click  on  a  file  the results will depend on how you have configured
  307.      PowerPlatform.  You  can  set up PowerPlatform so that when you double
  308.      click  on  a  file  a program is invoked and passed the file name as a
  309.  
  310.  
  311.                                PowerPlatform 1.0                     Page 6
  312.  
  313.  
  314.      parameter.  You  can  associate  different  file  types with different
  315.      programs.  For  example  you  can  set up PowerPlatform so that if you
  316.      select  a  file  that ends in .c your favorite text editor is started,
  317.      files  ending  in  .word  will start your favorite word processor etc.
  318.      All  this  is  covered  in more detail in the configuration section of
  319.      this  manual.  If  you  double  click on a file that has no associated
  320.      program, an error requester will be displayed.  
  321.  
  322.           One final  gadget  needs  to be covered, that is the little check
  323.      mark  at  the bottom of the directory area. This gadgets function will
  324.      become  apparent  as you follow this simple example. By now you should
  325.      know  how  to switch between the source and target directories and how
  326.      to  move  up  and  down the directory tree. We are now going to copy a
  327.      file.  Make  sure  the  target  directory  is displayed and select the
  328.      required  device.  For  this practice session it is best to select the
  329.      RAM:  device  if  you have one. Now switch to the source directory and
  330.      select  the  file you want to copy by clicking on it. Now click on the
  331.      Copy  function.  You  have now copied the file.  You can switch to the
  332.      target directory to verify this if you like.  
  333.  
  334.           If you  were  watching  carefully you might have noticed that the
  335.      current  target  directory,  RAM:  in our example was displayed at the
  336.      bottom  of  the  directory area. This is always the case regardless of
  337.      which  directory  is  currently  active.  Suppose you wanted to copy a
  338.      file  to  a  new  name. You can click on this gadget and enter the new
  339.      name.  For  example  click anywhere in this gadget and the cursor will
  340.      appear,  now  type  in the new name at the end of the target directory
  341.      and  select  a  file  and  the  copy  button again.  You can enter the
  342.      complete  target file specification in the target string gadget if you
  343.      prefer,  or  you  can  move  around  the  target directory display and
  344.      PowerPlatform  will  construct  the target name for you.  Lets copy it
  345.      one more time.  
  346.  
  347.           Supposing you  want  to  copy the Profile.APP file that came with
  348.      PowerPlatform  and want to call it Profile.APP.COPY. Select the source
  349.      directory,  target  directory  and  file  just  as you did before. Now
  350.      select  the check mark gadget. What happened? the name of the file you
  351.      selected  has  been  added  to  the target directory name.  Now simply
  352.      click  on  the  target  name gadget as you did before and add the COPY
  353.      extension.  Finally  hit the copy button. The little check mark gadget
  354.      can save you a lot of typing.  
  355.  
  356.           We have  covered  a  lot  of ground in this short section. By now
  357.      you  should  know  the PowerPlatform basics. We have discovered how to
  358.      select  the  active  directory, how to manoeuvre through the directory
  359.      tree,  how  to  select  files and how to copy a file. Now that you can
  360.      copy  a file you can easily rename it, erase it etc. Take a break from
  361.      the  manual at this point and play around with PowerPlatform to become
  362.      more  familiar  with  the  way  it works. It should not take too long.
  363.      Don't  forget  however  that you are playing with your real files. You
  364.      might  want  to start by copying some files to your RAM: disk and then
  365.      experimenting with the other functions.  
  366.  
  367.  
  368.      TThhee PPoowweerrPPllaattffoorrmm DDiisskk IInnffoorrmmaattiioonn AArreeaa 
  369.  
  370.           You should  now  be  familiar  with  the  first  two areas of the
  371.  
  372.  
  373.                                PowerPlatform 1.0                     Page 7
  374.  
  375.  
  376.      PowerPlatform  window,  the  directory area and the function area. The
  377.      last  area  is  the  disk  information area and it is displayed at the
  378.      bottom  of  the  window.  It  simply  displays  the current source and
  379.      target   volume  names  along  with  the  amount  of  space  used  and
  380.      available, (in bytes), for each device.  
  381.  
  382.  
  383.      TThhee PPoowweerrPPllaattffoorrmm MMeennuu BBaarr 
  384.  
  385.           You may   remember  that  you  can  add  you  own  menus  to  the
  386.      PowerPlatform  menu  bar.  The  PowerPlatform sample profile adds some
  387.      additional   menus.   If  you  have  not  already  done  so  start  up
  388.      PowerPlatform  and  run  quickly  through  the menu bar.  Just how you
  389.      define  your  own  menus  is described in the configuration section of
  390.      this  manual.  However,  regardless  of whether or not you define your
  391.      own menus, PowerPlatform always provides the following three menus: 
  392.  
  393.  
  394.           Project:   This   menu   contains  three  items,  About  displays
  395.                      information  about  PowerPlatform,  Screen changes the
  396.                      PowerPlatform  display  and  Quit  exits  the program.
  397.                      When  reporting  a problem with PowerPlatform you must
  398.                      always  provide  the  PowerPlatform  release  you  are
  399.                      using.  You  can  get  the release number by selecting
  400.                      the  about  menu item.  There are three screen options
  401.                      currently     supported,     WorkBench    opens    the
  402.                      PowerPlatform  window  on  the WorkBench screen, Hires
  403.                      opens  a  custom  HiRes  screen  and interlace opens a
  404.                      custom  HiRes-Interlaced  screen.   You  set  up  your
  405.                      default  screen  mode  in  your  profile  and  you can
  406.                      change   it   at  any  time  using  the  screen  menu.
  407.                      Additional  screen  options  will  be supported in the
  408.                      next release of PowerPlatform.  
  409.  
  410.  
  411.           Directory: This  menu  contains  many different directory display
  412.                      options.  By  default  PowerPlatform displays the file
  413.                      name  and  file  size in bytes. You can change this by
  414.                      selecting  the appropriate item from this menu. I will
  415.                      not  describe all the options here because they should
  416.                      be  self  explanatory.   Experiment!  The last item on
  417.                      the  Directory  menu,  the search pattern, brings up a
  418.                      requester   that  you  can  use  to  limit  the  files
  419.                      displayed.  By  default PowerPlatform displays all the
  420.                      files  and  subdirectories  in  the current directory.
  421.                      You  can  use  any valid AmigaDOS wild card characters
  422.                      to  control  which files are displayed.  Note that the
  423.                      search  pattern  option  only  effects which FILES are
  424.                      displayed.  The subdirectories are always displayed.  
  425.  
  426.  
  427.           Trace:     This  menu  controls ARexx trace functions. If you are
  428.                      familiar  with  ARexx  you  should  recognize the menu
  429.                      items.  Please  refer  to  your  ARexx manual for full
  430.                      information.  Basically tco opens the trace window and
  431.                      tcc  closes  it.  ts starts interactive tracing and te
  432.                      ends  it. Tracing is a very powerful part of ARexx. It
  433.  
  434.  
  435.                                PowerPlatform 1.0                     Page 8
  436.  
  437.  
  438.                      enables  you  to  quickly  and easily debug your ARexx
  439.                      EXEC;s.  
  440.  
  441.           That's it  for  the standard PowerPlatform menus. Be sure to read
  442.      the  configuration  section  of this manual for information on how you
  443.      can add your own menus.  
  444.  
  445.  
  446.  
  447.      __PP__oo__ww__ee__rr__PP__ll__aa__tt__ff__oo__rr__mm____CC__oo__nn__ff__ii__gg__uu__rr__aa__tt__ii__oo__nn 
  448.  
  449.           PowerPlatform can  be configured for just about any purpose. When
  450.      PowerPlatform  is  started  it  looks for a file called Profile.APP in
  451.      your  REXX:  directory. This file contains the commands that configure
  452.      PowerPlatform.  PowerPlatform  is  shipped  with  a basic profile that
  453.      includes the standard AmigaDOS commands and some common programs.  
  454.  
  455.           Any of   the   PowerPlatform   commands  listed  in  the  command
  456.      reference  section  of  this  manual  can be included in your profile.
  457.      Remember  that the PowerPlatform profile is just another ARexx EXEC so
  458.      you   can  also  include  standard  AmigaDOS  commands  or  any  other
  459.      utilities you require.  
  460.  
  461.           The following  section describes the sample profile in detail. It
  462.      should  give  you  a  good idea of how to set up your own profile. You
  463.      might  want to print off a copy of the Profile.APP file to refer to as
  464.      you  read  this section.  It is also a good idea to have PowerPlatform
  465.      running  so  that  you  can  see  what  effects  the  profile  has  on
  466.      PowerPlatform's window and functions.  
  467.  
  468.           Before changing  your  profile  be sure to make a backup copy. If
  469.      you  make  an error in your profile PowerPlatform may display an error
  470.      and  terminate.  If you have a backup copy you can easily recover from
  471.      this situation.  
  472.  
  473.      /*************************************************************/
  474.      /* This is the sample Profile for PowerPlatform Release 1.0. */
  475.      /*                                                           */
  476.      /*                                   ==> MCW 08/19/90 <==    */
  477.      /*                                                           */
  478.      /*            Copyright © 1990 Martin C. Warnett             */
  479.      /*************************************************************/
  480.  
  481.      trace off
  482.  
  483.      'Options Bytes'
  484.      'Options WorkBench'
  485.  
  486.  
  487.           The REXX  language  requires  that  the  first  line  of the EXEC
  488.      contain  a comment. A comment is delimited by a /* */ pair, as in /* a
  489.      comment  */.   It  does  not have to be very fancy but you must have a
  490.      comment as the first non-blank line in your EXEC.  
  491.  
  492.           Following the  comment  is a trace statement. It is currently set
  493.      to  off  which  means  the  EXEC  will  run  normally. The ARexx trace
  494.      facility  is a very powerful part of the language. When strange things
  495.  
  496.  
  497.                                PowerPlatform 1.0                     Page 9
  498.  
  499.  
  500.      start  happening  and  you  don't  understand  why  it's  time to turn
  501.      tracing  on.  Personally  I  prefer the interactive trace, just change
  502.      trace  off  to  trace  ?i  to  activate it. This is only a suggestion,
  503.      there  are a wide variety of tracing options which are defined in your
  504.      ARexx manual.  
  505.  
  506.           The two  options  statements will ensure that PowerPlatform opens
  507.      on  the  WorkBench  screen and that the directory display includes the
  508.      file size in bytes.  
  509.  
  510.  
  511.      'DefineDevice HardDisk 1 SYS:'
  512.      'DefineDevice HardDisk 2 DH0:'
  513.      'DefineDevice FloppyDisk 3 DF0:'
  514.      'DefineDevice RamDisk 4 RAD:'
  515.      'DefineDevice RamDisk 5 RAM:'
  516.      'DefineDevice HardDisk 6 NET:'
  517.      'DefineDevice FloppyDisk 7 MSH:'
  518.  
  519.  
  520.           This next   section   defines   the  devices  PowerPlatform  will
  521.      recognize.   Normally these will include all the disks in your system,
  522.      hard  disks, floppy disks and ram disks. You can also define any other
  523.      devices you may have mounted.  
  524.  
  525.           If you  look  at the PowerPlatform window you will see the device
  526.      gadgets  are  arranged  in  a  column  on the left. The numbers in the
  527.      above  DefineDevice  commands  simply  control the position within the
  528.      device   column.   The   device  type  simply  controls  which  gadget
  529.      PowerPlatform  uses to display the device.  So for example device DH0:
  530.      is  the  second device and the gadget displayed indicates that it is a
  531.      hard disk.  
  532.  
  533.           In the  sample profile I include NET: which is the ParNet2 device
  534.      and  MSH:  which  is  the  MessyDOS device. You can find both of these
  535.      programs  on  most  bulletin  boards.  ParNet  allows  you to link two
  536.      Amigas  together via their parallel ports. MessyDOS allows you to read
  537.      MS-DOS  720K floppy disks on your Amiga. You have full access to these
  538.      other  devices  from within PowerPlatform. You can copy files from one
  539.      Amiga to another and read and write MS-DOS disks too! 
  540.  
  541.  
  542.      'CDSource RAM:'
  543.      'CDTarget RAM:'
  544.  
  545.  
  546.           These two  commands  just establish the default source and target
  547.      directories.  The  directory  specification  must  include  one of the
  548.      device names you defined earlier. For example: 
  549.  
  550.      CDSource DH0:Utilities.  
  551.  
  552.  
  553.           When PowerPlatform  starts  it  will initially display the source
  554.      directory.  You  can  specify any device you want but if you specify a
  555.      large  hard  disk  partition  it  may take longer for PowerPlatform to
  556.      initialize because it has to read the root directory of the device.  
  557.  
  558.  
  559.                                PowerPlatform 1.0                    Page 10
  560.  
  561.  
  562.      'DefineConsole 1 CON:0/50/640/100/Console1'
  563.      'DefineConsole 2 CON:0/25/640/150/Console2'
  564.      'DefineConsole 3 CON:40/20/640/430/Console3'
  565.  
  566.  
  567.           These commands  define  console  windows that can be used to view
  568.      the  output  of  commands  run  from within PowerPlatform. You can run
  569.      commands  in  the  background  in which case you do not see any output
  570.      from  the  command.  You  will  probably  want to run the copy, rename
  571.      commands  etc.  in  this way. You will want to see the output of other
  572.      commands  however  and  some  will  require you to enter data. In this
  573.      case  you  can  use  one of your console definitions. You will see how
  574.      you  direct  the  output  of  a command to a particular console in the
  575.      next section.  
  576.  
  577.           The advantage  to defining multiple consoles is that you can size
  578.      the  console  to  the  expected output of the command. You probably do
  579.      not  want to obscure the entire screen for a command that only outputs
  580.      1  line  of text.  You can use any console handler you like, (NEWCON:,
  581.      Conman  etc.),  just  make  sure that your definition is valid for the
  582.      console handler you are using as PowerPlatform cannot validate it.  
  583.  
  584.  
  585.      'DefineMenu Utilities'
  586.      'DefineItem WB Calculator SYS:Tools/Calculator'
  587.      'DefineItem WB KEY=M MeMacs SYS:Tools/MeMacs'
  588.      'DefineItem WB Clock SYS:Utilities/Clock'
  589.      'DefineItem WB Say SYS:Utilities/Say'
  590.  
  591.  
  592.           These commands  are  defining the PowerPlatform menu bar. You can
  593.      add  up  to  five additional menus to the PowerPlatform menu bar. Here
  594.      we  show  just one additional menu that has 4 items. The first item is
  595.      the  standard  Amiga calculator. The WB instructs PowerPlatform to run
  596.      this  program  as  if  it  were  run  from the WorkBench. You can also
  597.      specify  CLI,  which  means  run it as if it were run from the command
  598.      line and ARexx which means that the program is an ARexx EXEC.  
  599.  
  600.           The second  item includes a keyboard alternative. This means that
  601.      you  can  run  the  program  by  selecting  it from the menu bar or by
  602.      simply pressing the right Amiga key and the letter M.  
  603.  
  604.  
  605.      'DefineExt CLI Run CDSource ToWB C DME &sf'
  606.      'DefineExt CLI Run CDSource ToWB H DME &sf'
  607.      'DefineExt ARexx rexx &sf'
  608.      'DefineExt ARexx APP &sf'
  609.  
  610.  
  611.           These commands  associate  files  with  programs. When you double
  612.      click  on  the file PowerPlatform will start the specified program and
  613.      pass  it  the  name of the file. This is just a shortcut, it saves you
  614.      having  to  move  the  mouse  after  selecting  the file to select the
  615.      appropriate function button.  
  616.  
  617.           It's starting  to  get a little complicated here as PowerPlatform
  618.      provides  many options for you to control program execution. The first
  619.  
  620.  
  621.                                PowerPlatform 1.0                    Page 11
  622.  
  623.  
  624.      command  is  associating  files with an extension of C, (i.e. they end
  625.      in  .c),  with  the editor DME. The CLI option instructs PowerPlatform
  626.      to invoke DME as if it was run from the command line.  
  627.  
  628.           By default  PowerPlatform  waits for a command to complete before
  629.      it  allows  you  to  select another function. The Run option instructs
  630.      PowerPlatform  to  invoke  it  as a separate task. This is exactly the
  631.      same  as  using  the  AmigaDOS Run command. If you were to execute DME
  632.      from  the  command  line  it would tie up the command line shell until
  633.      you  quit  DME.   If  you entered Run DME at the command line it would
  634.      free up the shell immediately.  
  635.  
  636.           CDSource instructs  PowerPlatform  to  make  the  current  source
  637.      directory  the  current  directory  for  the  DME task. There are many
  638.      reasons  you  might  want  to  do  this  when executing a program. For
  639.      example  the  program  may  look  for  certain  files  in  the current
  640.      directory.  In  this  case  it  is  so  that when we bring up the file
  641.      requester  in  DME,  it  will  default  to  the  current PowerPlatform
  642.      directory.  This  can  save  you a few steps if you have related files
  643.      that you might need in this directory.  
  644.  
  645.           ToWB is  only  applicable  if you have started PowerPlatform on a
  646.      custom  screen.  It  will  not  hurt if you have started PowerPlatform
  647.      from  the  WorkBench  and  use this option, it just does not serve any
  648.      purpose.   PowerPlatform  will  make  the  WorkBench the active screen
  649.      before  starting  DME  so  that  the  DME  window  becomes  the active
  650.      window.   This saves you having to manually switch screens to find the
  651.      DME window.  
  652.  
  653.           C is  the  file  extension  to  associate  DME  with.  DME is the
  654.      program  name.   In  this  case it is on the path so we do not need to
  655.      specify  the  directory, but if it were not you could specify the full
  656.      name  here.  The &SF is a place marker that tells PowerPlatform to put
  657.      the  selected file at this location in the command line when executing
  658.      the  program.  So in this case when you double click on a file with an
  659.      extension  of  C,  PowerPlatform  will construct a command line in the
  660.      form of DME filename.c.  
  661.  
  662.           The third  command  associates  files  with  an extension of rexx
  663.      with...  what?  The  actual file itself.  Remember that &SF represents
  664.      the  selected  file  name  and in this case it's the only thing in the
  665.      command  line parameter.  This command is instructing PowerPlatform to
  666.      execute   the   selected   file.    The   ARexx  option  indicates  to
  667.      PowerPlatform that it is an ARexx EXEC.  
  668.  
  669.           The general  syntax for all PowerPlatform commands is the command
  670.      name  followed by any command options you wish to specify, followed by
  671.      the  required parameters. The command reference section of this manual
  672.      includes  a complete list of all PowerPlatform commands, their options
  673.      and required parameters.  
  674.  
  675.  
  676.      'DefineFunction 1 TagAll TagAll'
  677.      'DefineFunction 2 Reset Reset'
  678.      'DefineFunction Run CDSource 3 Shell NewShell',
  679.          'CON:0/50/640/100/AmigaShell'
  680.      'DefineFunction Sleep TargetRefresh 6 Copy',
  681.  
  682.  
  683.                                PowerPlatform 1.0                    Page 12
  684.  
  685.  
  686.          'copy FROM &sf TO &tf COM'
  687.      'DefineFunction Sleep TargetRefresh 7 CopyAll',
  688.          'copy FROM &sf TO &tf COM ALL'
  689.      'DefineFunction Sleep Confirm SourceRefresh 8 Erase',
  690.          'delete &sf'
  691.      'DefineFunction Sleep Confirm SourceRefresh 9 EraseAll',
  692.          'delete &sf ALL'
  693.      'DefineFunction Sleep SourceRefresh TargetRefresh 10 Rename',
  694.          'rename FROM &sf TO &tf'
  695.      'DefineFunction TargetRefresh 11 MakeDir Makedir &tf'
  696.      'DefineFunction Run 16 More more &sf'
  697.      'DefineFunction Run NoSelect 17 Edit DME &sf'
  698.      'DefineFunction Sleep Console=1 TargetRefresh CLI 21 Format',
  699.          'FORMAT DRIVE &td NAME NEW NOICONS'
  700.      'DefineFunction Sleep Console=1 TargetRefresh CLI 22 DiskCopy',
  701.          'DISKCOPY FROM &sd TO &td'
  702.      'DefineFunction 26 Viewer SuperView &sf'
  703.      'DefineFunction CDSource NoQuote 31 Do &sf'
  704.      'DefineFunction CDSource 32 Run Run &sf'
  705.      'DefineFunction CDSource 33 Execute Execute &sf'
  706.      'DefineFunction Console=2 CDSource SourceRefresh ARexx 34',
  707.          'Extract Extract &SF'
  708.  
  709.  
  710.           You were  introduced  to  some  of the many options PowerPlatform
  711.      supports  when  we  discussed  the  DefineMenu  and DefineExt commands
  712.      above.  Now  we are going to cover the DefineFunction command. This is
  713.      the  most  important  PowerPlatform  command,  it defines the function
  714.      buttons.  Many  of  the  options  are the same so the above statements
  715.      taken from the sample profile should already be familiar.  
  716.  
  717.           The first  statement  is  defining  function  button  1. Function
  718.      buttons  are  numbered in the same way that devices were numbered. The
  719.      function  number  simply  determines  where PowerPlatform will display
  720.      the function button.  
  721.  
  722.           Following the  function  number is the function button label, and
  723.      following that the command that will be executed.  
  724.  
  725.           The first  command  is  TagAll.  This is a built in PowerPlatform
  726.      command.   There  are  only  two  built  in commands TagAll and Reset.
  727.      TagAll  will  select  all  the directory entries in the current source
  728.      directory. Reset will deselect any selected entries.  
  729.  
  730.           Function number  6  defines  the  copy  command. Notice that this
  731.      definition  is  split over two lines. This is for readability purposes
  732.      only.  You  should  refer  to  your ARexx manual for details on how to
  733.      continue Arexx commands.  
  734.  
  735.           There are  a couple of new options introduced for the first time.
  736.      As  mentioned  earlier  PowerPlatform  will  wait  until  the  command
  737.      completes  before  it  will process further commands. The sleep option
  738.      instructs   PowerPlatform  to  display  the  standard  intuition  busy
  739.      pointer until the command completes.  
  740.  
  741.           TargetRefresh instructs   PowerPlatform  to  refresh  the  target
  742.      directory  when  the command completes. As the copy command copies the
  743.  
  744.  
  745.                                PowerPlatform 1.0                    Page 13
  746.  
  747.  
  748.      selected  files  to  the  target  directory this makes a lot of sense.
  749.      Note  that  if the target directory is currently the active directory,
  750.      the  directory  will be refreshed immediately. If the source directory
  751.      is  active, the target directory will be refreshed when it becomes the
  752.      active directory.  
  753.  
  754.           The &TF  in the copy command performs the same purpose as &SF, it
  755.      tells  PowerPlatform  where  to  insert  the target file specification
  756.      when  constructing the command line. The command is specified as 'COPY
  757.      FROM  &SF  TO  &TF  COM'. If you take a look at the AmigaDOS reference
  758.      manual  you  will  see that this command is the standard AmigaDOS copy
  759.      command. You can change the copy command options as necessary.  
  760.  
  761.           Function 8  defines  the  erase  command. This introduces another
  762.      new  option,  Confirm.  This  instructs  PowerPlatform  to  display  a
  763.      requester  asking  you  to  confirm  the  command.  This  is  simply a
  764.      safeguard that should be used for potentially destructive commands.  
  765.  
  766.           Function 17  defines the Edit command. The editor in this case is
  767.      the  public domain DME but you can change this definition to reference
  768.      your  favorite  editor.  Normally  if you select a function button but
  769.      you  have not selected a file in the source directory, the function is
  770.      ignored.  This  makes  sense for most commands, you cannot copy a file
  771.      without  selecting  one  first. But you might want to invoke an editor
  772.      without  selecting  a  file.  The  NoSelect  option  allows  you to do
  773.      exactly this.  
  774.  
  775.           Function 21  defines  the  format  command. This command requires
  776.      user  input  so a console is referenced so that you can see the output
  777.      from  the command and respond to it's prompts. The console was defined
  778.      earlier  using the DefineConsole command. The format command also uses
  779.      the  &TD  place  marker.   PowerPlatform  will  replace  &TD  with the
  780.      current target device, not the full file name.  
  781.  
  782.           One final  new  option  and  we're done! By default PowerPlatform
  783.      puts  double  quotes  around  the  file name when it is formatting the
  784.      command  line.  The  double  quotes  are  required  when the file name
  785.      contains  special characters such as a space. Normally it does no harm
  786.      to  add  quotes all the time, but there are a few programs that do not
  787.      handle  quotes  correctly. The NoQuotes option instructs PowerPlatform
  788.      not to put quotes around the file name.  
  789.  
  790.           Hopefully the  sample PowerPlatform profile now makes some sense.
  791.      The  complete syntax of all the PowerPlatform commands can be found in
  792.      the command reference section of this manual.  
  793.  
  794.           Remember that  if  after altering your profile things do not work
  795.      as  expected  you  can always activate the ARexx trace facility to see
  796.      exactly  what is going on. Simply select the tco menu item to open the
  797.      ARexx  tracing  window  and  then  select ts to activate tracing. Each
  798.      command  will  be displayed before it is executed and you will see the
  799.      actual   command   line   that   PowerPlatform   has   formatted.  The
  800.      PowerPlatform  place  holders will have been replaced by the real file
  801.      name. You should be able to easily debug your profile.  
  802.  
  803.  
  804.  
  805.  
  806.  
  807.                                PowerPlatform 1.0                    Page 14
  808.  
  809.  
  810.      __AA__dd__vv__aa__nn__cc__ee__dd____PP__oo__ww__ee__rr__PP__ll__aa__tt__ff__oo__rr__mm____CC__oo__nn__ff__ii__gg__uu__rr__aa__tt__ii__oo__nn 
  811.  
  812.           One of  the  more  unusual  features of PowerPlatform is that you
  813.      can  redefine  the function buttons at any time. The function area can
  814.      get  really  cluttered if you fill it with function buttons and it can
  815.      take time to find the one you are looking for.  
  816.  
  817.           Another approach  is  to set up groups of function buttons. Maybe
  818.      you  could  define  a  utility  group,  a  group  of  word  processing
  819.      functions,  a  group  of  development  functions,  a group of graphics
  820.      functions  etc. Then you can add a menu or define a function button to
  821.      execute an ARexx EXEC to change to another group at any time.  
  822.  
  823.           In my  own  profile  I have defined a Function menu.  When I need
  824.      to  do  some  word  processing  I select the appropriate function menu
  825.      item   and   all  my  buttons  are  immediately  redefined.   My  word
  826.      processing  tools  are  instantly available. When it's time to do some
  827.      graphics  work,  select  the graphics menu item and a whole new set of
  828.      function buttons appear.  
  829.  
  830.           Using this  technique  you  can have a virtually unlimited number
  831.      of  function  buttons defined and by grouping them logically you never
  832.      have trouble finding the one you want.  
  833.  
  834.           To change  your  function  button definitions just write an ARexx
  835.      EXEC  and  issue  the  ClearFunctions  command to remove your existing
  836.      function  button  definitions, define your new ones and then issue the
  837.      ReDrawFunctions command to display the new buttons.  
  838.  
  839.           As always  you  can  include  any  PowerPlatform  command in your
  840.      EXEC.  Another useful one in this situation is the CDSource command to
  841.      change  the current PowerPlatform source directory. When you switch to
  842.      your  word  processing functions you might also want to switch to your
  843.      word processing directory.  
  844.  
  845.           This feature  can be very powerful. Take some time to think about
  846.      how  you  can  group  your  functions together and set up you function
  847.      buttons.  
  848.  
  849.  
  850.  
  851.      __WW__rr__ii__tt__ii__nn__gg____yy__oo__uu__rr____oo__ww__nn____PP__oo__ww__ee__rr__PP__ll__aa__tt__ff__oo__rr__mm____EE__XX__EE__CC__''__ss 
  852.  
  853.           Now that  you  have  successfully  configured PowerPlatform using
  854.      ARexx  you're  ready for the next step, writing your own EXEC's to run
  855.      under PowerPlatform. You can use ARexx for practically anything.  
  856.  
  857.           A good   example   is   the   Extract.APP   EXEC   shipped   with
  858.      PowerPlatform.  This  EXEC  will  decompress  a  file  that  has  been
  859.      previously  compressed  using  the  LHARC,  ZOO,  ZIP, ARC or UUENCODE
  860.      programs.  Obviously  you can only run this EXEC on your system if you
  861.      have installed these programs.  
  862.  
  863.           To use  it,  you  must  first define a function button similar to
  864.      this: 
  865.  
  866.      'DefineFunction ARexx Console=2 10 Extract Extract &SF' 
  867.  
  868.  
  869.                                PowerPlatform 1.0                    Page 15
  870.  
  871.  
  872.  
  873.           By now  you should realize that this command will define function
  874.      button  number  10.   PowerPlatform  will  label the button "Extract".
  875.      When  you  click  on  the button PowerPlatform will open the specified
  876.      console,  and  execute  the  ARexx  program  using  the  command  line
  877.      "Extract filename".  
  878.  
  879.      parse upper arg fname
  880.  
  881.      if fname = '' then do
  882.          'Message No filename Specified.'
  883.          'Beep'
  884.          return
  885.      end
  886.  
  887.           The first  thing this EXEC does is to get the file name passed on
  888.      the   command   line.   If  there  is  no  file  name  it  issues  the
  889.      PowerPlatform   Message   command   to   display   a  message  in  the
  890.      PowerPlatform  title bar, beeps and terminates.  Note that this is not
  891.      strictly  necessary  às  PowerPlatform  will  never  execute  this EXEC
  892.      unless a filename was selected.  
  893.  
  894.      ftype = substr(fname, lastpos(".", fname) +1)
  895.  
  896.      if ftype = "ARC" then do
  897.          address command 'ARC <* e' fname
  898.          return
  899.      end
  900.  
  901.           Next we  will  strip  off  the  file  extension  so  that  we can
  902.      determine  the  file format and therefore which program to invoke. The
  903.      above  statements  show how the ARC program is executed. Once the file
  904.      has  been decompressed the EXEC terminates. The other file formats are
  905.      handled in a similar manner but they are not shown here.  
  906.  
  907.      'Message Unrecognized file type.'
  908.      'Beep'
  909.  
  910.      return 0
  911.  
  912.           If the  file  type  is  not  recognized then the above statements
  913.      will  be  executed.  Again  we  will  display  an error message in the
  914.      PowerPlatform  title bar, sound the alarm and terminate. We could have
  915.      returned  with  a  non  zero  return code, in which case PowerPlatform
  916.      will  display a requester with the return code. This is another way of
  917.      indicating that an error has occurred.  
  918.  
  919.           Be sure  to  take  a  look at the full Extract.APP file which you
  920.      should  have  copied  to  your  REXX:  directory  when  you  installed
  921.      PowerPlatform.  
  922.  
  923.           If some  of  the  above  statements  do not make sense you should
  924.      find the answers in your ARexx manual.  
  925.  
  926.  
  927.  
  928.      __PP__oo__ww__ee__rr__PP__ll__aa__tt__ff__oo__rr__mm____CC__oo__mm__mm__aa__nn__dd____RR__ee__ff__ee__rr__ee__nn__cc__ee 
  929.  
  930.  
  931.                                PowerPlatform 1.0                    Page 16
  932.  
  933.  
  934.  
  935.           The PowerPlatform command format is: 
  936.  
  937.                Command Options Parameters 
  938.  
  939.           In this   section   of   the   manual  all  commands  are  listed
  940.      alphabetically  by  command name. Required parameters are specified in
  941.      square  brackets.  When  coding  the  commands  you  must  replace the
  942.      descriptive  text in square brackets with an appropriate value. Do not
  943.      code the square brackets.  
  944.  
  945.           Options are  coded  within  braces  and  are  presented after the
  946.      actual  command  description.  It  you  specify  an  option it must be
  947.      placed  after  the  command  name  and before the required parameters.
  948.      Options  are  presented  in  mixed case for readability. PowerPlatform
  949.      commands  are  not  case  sensitive and you may enter them however you
  950.      wish.  If  the  options  are  separated by spaces then you may code as
  951.      many  of  them as you need. If the options are separated by | then you
  952.      must  pick  only  one.  If  an  option  is underlined then this is the
  953.      default.  
  954.  
  955.           The following  PowerPlatform commands are available. Any of these
  956.      commands  may be included in your PowerPlatform profile. Most commands
  957.      can also be included in any PowerPlatform ARexx EXEC you write.  
  958.  
  959.  
  960.  
  961.      Beep 
  962.  
  963.                       The  Beep command will sound an audible alarm. It can
  964.                       be  used at any time but normally it would be used to
  965.                       signal an error or exceptional condition.  
  966.  
  967.  
  968.      CDSource         [directory] 
  969.  
  970.                       This  command  will  change the current PowerPlatform
  971.                       source  directory.  The  directory specification must
  972.                       always  start  with  a  device  name,  one previously
  973.                       defined using the DefineDevice command.  
  974.  
  975.  
  976.      CDTarget         [directory] 
  977.  
  978.                       This  command  will  change the current PowerPlatform
  979.                       target  directory.  The  directory specification must
  980.                       always  start  with  a  device  name,  one previously
  981.                       defined using the DefineDevice command.  
  982.  
  983.  
  984.      ClearFunctions 
  985.  
  986.                       This   command   will   remove  all  function  button
  987.                       definitions.  It is designed to be used when you wish
  988.                       to  change  the  assignments of the function buttons.
  989.                       If  you  attempt to define a function button that has
  990.                       already  been  defined,  (i.e. the function number is
  991.  
  992.  
  993.                                PowerPlatform 1.0                    Page 17
  994.  
  995.  
  996.                       already  in use), PowerPlatform will display an error
  997.                       requester.   Use  this  function  to  clear  existing
  998.                       definitions before defining new ones.  
  999.  
  1000.  
  1001.      DefineColor      [pen number] [red] [green] [blue] 
  1002.  
  1003.                       This   command   will   change   the  colors  of  the
  1004.                       PowerPlatform  screen. This command is only effective
  1005.                       if  you have opened PowerPlatform on a custom screen.
  1006.                       It  will  be ignored if you have opened PowerPlatform
  1007.                       on the WorkBench.  
  1008.  
  1009.                       The  PowerPlatform screen is an eight color screen so
  1010.                       the  pen  number  must  be in the range 0-7. The red,
  1011.                       green  and  blue values must be in the range 0-15 and
  1012.                       indicate  the  amount  of  red,  green or blue in the
  1013.                       required color.  
  1014.  
  1015.                       By  default  PowerPlatform  will  use  your WorkBench
  1016.                       colors  as  the  first  four  colors  of  it's custom
  1017.                       screen, (pens 0-3).  
  1018.  
  1019.  
  1020.      DefineConsole    [console number] [console definition] 
  1021.  
  1022.                       This  command  is  used  to define a console that can
  1023.                       then  be  used  for  command  input  and  output. The
  1024.                       console  number  must  be  in the range 1-10 and will
  1025.                       identify  the  console  when  it is later referenced.
  1026.                       The   console   definition   must   conform   to  the
  1027.                       requirements   of  your  console  manager,  AmigaDOS,
  1028.                       ConMan etc.  
  1029.  
  1030.  
  1031.      DefineDevice     [device number] [device name] 
  1032.                       { _H_a_r_d_D_i_s_k | FloppyDisk | RAMDisk} 
  1033.  
  1034.                       This   command   is   used   to  define  the  devices
  1035.                       PowerPlatform  will  display in the directory area of
  1036.                       it's  window.  PowerPlatform  includes  a  column  of
  1037.                       gadgets  on  the  left  side  of it's window. You can
  1038.                       then  click on these gadgets to select the source and
  1039.                       target devices.  
  1040.  
  1041.                       Device  number identifies the position of the gadget,
  1042.                       1  is  the  top gadget and 20 is the bottom. There is
  1043.                       no  guarantee  that  the  devices  will be visible as
  1044.                       PowerPlatform  will  only  display as many devices as
  1045.                       will   fit  in  it's  window  and  ignore  the  rest.
  1046.                       Enlarging  the  window  will  cause additional device
  1047.                       gadgets to be displayed.  
  1048.  
  1049.                       Device   name   identifies   the   device.  Currently
  1050.                       PowerPlatform  limits the device name to 4 characters
  1051.                       including  the  colon,  e.g. DH0:, DF1: RAM:. If your
  1052.                       device  name  is  longer  than  four  characters  you
  1053.  
  1054.  
  1055.                                PowerPlatform 1.0                    Page 18
  1056.  
  1057.  
  1058.                       should  use the AmigaDOS assign statement to define a
  1059.                       4 character name for the device and use that.  
  1060.  
  1061.                       The  device  type  option  can  be  one  of the three
  1062.                       specified   values.  This  parameter  controls  which
  1063.                       gadget  PowerPlatform  uses  to represent the device.
  1064.                       It  serves no other purpose and you can use whichever
  1065.                       gadget  you  like,  i.e.  you  don't  have to use the
  1066.                       HardDisk gadget for your hard disk.  
  1067.  
  1068.  
  1069.      DefineExt        [file extension] [command] 
  1070.                       [ARexx | _C_L_I | WB} 
  1071.                       {CDPath | CDSource | CDTarget} 
  1072.                       {SwitchWB | ToWB} 
  1073.                       {Confirm  Console=  NoQuote  Run  Sleep SourceRefresh
  1074.                       Stack= TargetRefresh} 
  1075.  
  1076.                       This  command  is  used to associate a file extension
  1077.                       with  a program. Then when you double click on a file
  1078.                       with  the  specified  extension  that program will be
  1079.                       invoked with the file name as a parameter.  
  1080.  
  1081.                       The  file  extension  is  the  last  section  of  the
  1082.                       filename  delimited by a period. You must not specify
  1083.                       the period just the extension.  
  1084.  
  1085.                       The  command  identifies  the  program  you  want  to
  1086.                       associate  with  the file extension. If the specified
  1087.                       program  is  not  on  your path then you must specify
  1088.                       the full path and file name.  
  1089.  
  1090.                       Specify  ARexx,  CLI  or  WB  to identify the type of
  1091.                       program you want to execute.  
  1092.  
  1093.                       Refer   to   the   DefineFunction   command   for   a
  1094.                       description  of  the other options. You can include a
  1095.                       maximum of 25 DefineExt commands.  
  1096.  
  1097.                       Example: 'DefineExt ToWB C dme &SF' 
  1098.  
  1099.                       In  the  above example whenever you double click on a
  1100.                       file  ending  in  .c  the  DME editor will be invoked
  1101.                       with  the filename as a parameter. PowerPlatform will
  1102.                       switch  to  the  WorkBench screen before starting the
  1103.                       program.  
  1104.  
  1105.  
  1106.      DefineFunction   [function    number]   [function   label]   [function
  1107.                       command] 
  1108.                       {ARexx | _C_L_I | WB} 
  1109.                       {CDPath | CDSource | CDTarget} 
  1110.                       {SwitchWB | ToWB} 
  1111.                       {Confirm   Console=   NoQuote   NoSelect   Run  Sleep
  1112.                       SourceRefresh Stack= TargetRefresh} 
  1113.  
  1114.                       This  PowerPlatform  command  defines  each  function
  1115.  
  1116.  
  1117.                                PowerPlatform 1.0                    Page 19
  1118.  
  1119.  
  1120.                       button,   where  it  displays,  it's  label  and  the
  1121.                       command   that   must  be  executed  whenever  it  is
  1122.                       selected.  
  1123.  
  1124.                       The  function number is used to position the function
  1125.                       button.  PowerPlatform  allows you to define up to 75
  1126.                       buttons   at   a   time.  PowerPlatform  then  starts
  1127.                       displaying  them in the function area of it's window.
  1128.                       How  many  function  buttons will display on each row
  1129.                       and  how  many  rows will display depends on the size
  1130.                       of  the  PowerPlatform  window.  As  you  reduce  and
  1131.                       enlarge   the   window,   the  function  buttons  are
  1132.                       adjusted.  It you skip function numbers that space is
  1133.                       left  empty,  thus you can space the function buttons
  1134.                       as  desired.  It's  probably a good idea to group the
  1135.                       functions   together   logically   and  leave  spaces
  1136.                       between  groups  to delineate them. Remember that you
  1137.                       can  redefine  the function buttons at any time using
  1138.                       an ARexx EXEC.  
  1139.  
  1140.                       The  function  label  can be up to 8 characters long.
  1141.                       The  label  cannot contain spaces. Powerplatform will
  1142.                       automatically   center  the  label  in  the  function
  1143.                       button image.  
  1144.  
  1145.                       The  command  is  the  program  that will be executed
  1146.                       whenever  the  function  button is selected. You code
  1147.                       the  command  exactly  as  if you were entering it on
  1148.                       the  command  line  except  that  you use the special
  1149.                       PowerPlatform  place markers, &SF and &TF to position
  1150.                       the   source  and  target  files  respectively.   For
  1151.                       example   supposing   you   were  defining  the  copy
  1152.                       command. You might specify the command as: 
  1153.  
  1154.                                 Copy &SF to &TF 
  1155.  
  1156.                       When  you select the function PowerPlatform will then
  1157.                       issue  this  command  and  substitute  the  currently
  1158.                       selected  source  file  for the &SF and the currently
  1159.                       selected  target  file  for  the  &TF.  There are two
  1160.                       other   place  markers  that  you  can  specify.  &SD
  1161.                       instructs   PowerPlatform   to  specify  the  current
  1162.                       source  device  name. You might use this place marker
  1163.                       when  constructing  a  format  command as format only
  1164.                       takes   a   device  name  as  input.   &SP  instructs
  1165.                       PowerPlatform  to  insert  the current source path at
  1166.                       this  point  in the command. You can also specify &TD
  1167.                       and &TP of course.  
  1168.  
  1169.                       Normally  when  you  select multiple source directory
  1170.                       files,  PowerPlatform  invokes  the specified command
  1171.                       multiple  times, passing a different source file name
  1172.                       every  time. Sometimes however the program might want
  1173.                       all  the  selected  files  as  input.  In  this  case
  1174.                       specify  &SA  instead of &SF. An example of using &SA
  1175.                       might  be  an IFF viewer. You would probably not want
  1176.                       to  invoke  the  viewer  once  for  each file as most
  1177.  
  1178.  
  1179.                                PowerPlatform 1.0                    Page 20
  1180.  
  1181.  
  1182.                       viewers  allow  you  to specify multiple files on the
  1183.                       command  line.  There  is  one potential problem with
  1184.                       selecting  multiple  files,  the command line can get
  1185.                       quite  long.  Most  programs  cannot  handle  command
  1186.                       lines  that  exceed  255  characters. If this happens
  1187.                       PowerPlatform displays an error requester.  
  1188.  
  1189.                       Specify  ARexx, CLI or WB so that PowerPlatform knows
  1190.                       how to invoke the specified program.  
  1191.  
  1192.                       PowerPlatform   will  change  the  current  directory
  1193.                       before  executing  the  command  if required. You can
  1194.                       specify  CDSource  or CDTarget and PowerPlatform will
  1195.                       use  it's  current source or target directory. If you
  1196.                       specify  CDPath PowerPlatform will strip off the path
  1197.                       from  the  command  name  and  make  that the current
  1198.                       directory.  
  1199.  
  1200.                       SwitchWB  and ToWB options are only applicable if you
  1201.                       are  running  PowerPlatform  on  a custom screen. You
  1202.                       can  safely  include  them even if you are running on
  1203.                       the   WorkBench,  they  just  have  no  effect.  Many
  1204.                       programs  open  a  window  on the WorkBench when they
  1205.                       start  up.  If  PowerPlatform  is running on a custom
  1206.                       screen  you  must  manually  switch  to the WorkBench
  1207.                       screen  to  see  the  window.  SwitchWB automatically
  1208.                       switches   to   the  WorkBench  screen  for  you  and
  1209.                       switches   back   when  the  program  finishes.  ToWB
  1210.                       switches  to  the  WorkBench  screen and stays there.
  1211.                       You   have   to   manually   switch   back   to   the
  1212.                       PowerPlatform screen.  
  1213.  
  1214.                       The  Confirm  option  is  designed  to  be  used with
  1215.                       potentially  destructive  commands.  It  displays  an
  1216.                       "are  you  sure"  requester  prior  to  executing the
  1217.                       command.  You  then  have the option of executing the
  1218.                       command or cancelling it.  
  1219.  
  1220.                       Some  commands  can  quite  happily  execute  in  the
  1221.                       background   which   is  how  PowerPlatform  normally
  1222.                       executes  commands.  But  sometimes  the command will
  1223.                       need  additional  input  or  it might be important to
  1224.                       see  the  output  of  a  command.  The  DefineConsole
  1225.                       command  can  be  used  to  define up to 10 different
  1226.                       consoles.  These  can be all different sizes. You can
  1227.                       then  use  the Console= parameter to reference one of
  1228.                       your  predefined  consoles.  PowerPlatform  will open
  1229.                       the  console  and direct all command input and output
  1230.                       to   it.    PowerPlatform  automatically  closes  the
  1231.                       console when the program terminates.  
  1232.  
  1233.                       When  constructing the command PowerPlatform normally
  1234.                       wraps  the selected file names in double quotes. This
  1235.                       is   required  if  the  file  name  contains  special
  1236.                       characters   such   as   spaces.  Unfortunately  some
  1237.                       programs  cannot  handle  these  quotes.  Specify the
  1238.                       NoQuote  option and PowerPlatform will not add quotes
  1239.  
  1240.  
  1241.                                PowerPlatform 1.0                    Page 21
  1242.  
  1243.  
  1244.                       to the file name.  
  1245.  
  1246.                       When  you  click  on a function button, PowerPlatform
  1247.                       checks  to  see if you have selected any files in the
  1248.                       source  directory. It will then execute the specified
  1249.                       command  once  for  every selected file, or once with
  1250.                       all  files  passed  as  input  if you specify the &SA
  1251.                       place  marker.  However  if you have not selected any
  1252.                       files  PowerPlatform  does  not  execute the command.
  1253.                       This  normally  makes  sense,  you  can't copy a file
  1254.                       unless  you  select one. However there are some cases
  1255.                       where  it is useful to execute a program even when no
  1256.                       file  has  been selected. If you specify the NoSelect
  1257.                       option  PowerPlatform will always execute the command
  1258.                       at least once.  
  1259.  
  1260.                       When  PowerPlatform  executes  a  command it normally
  1261.                       waits  for  the  command  to  complete before it will
  1262.                       process  the  next  command.  If  you specify the Run
  1263.                       option,  PowerPlatform  will execute the command as a
  1264.                       separate  task  and not wait for it to complete. This
  1265.                       is the same as using the AmigaDOS run command.  
  1266.  
  1267.                       If  you  specify the Sleep option, PowerPlatform will
  1268.                       display  the  standard Amiga busy mouse pointer until
  1269.                       the command completes.  
  1270.  
  1271.                       The  SourceRefresh and TargetRefresh options instruct
  1272.                       PowerPlatform  to  reread  the  source  and or target
  1273.                       directories  when  the  command  completes. You would
  1274.                       normally   specify  this  when  you  execute  a  file
  1275.                       manipulation command such as copy or delete.  
  1276.  
  1277.                       Use  the  Stack=  option  to specify a stack size for
  1278.                       the  command.  Most  programs  will  state  in  their
  1279.                       documentation  if  they  need  more than the standard
  1280.                       4000  byte  stack.   If  your  default  stack size is
  1281.                       insufficient  use  this  option  to  enlarge it.  The
  1282.                       Stack=  option  is  only  for the current command, it
  1283.                       does not permanently change your stack size.  
  1284.  
  1285.  
  1286.      DefineItem       [item label] [item command] 
  1287.                       [ARexx | _C_L_I | WB} 
  1288.                       {CDPath | CDSource | CDTarget} 
  1289.                       {Console= Key= Stack=} 
  1290.  
  1291.                       PowerPlatform  allows  you  to  specify five menus to
  1292.                       add  to  the  existing  PowerPlatform  menu  bar. You
  1293.                       start  by  using the DefineMenu command to define the
  1294.                       new  menu and follow that with DefineItem commands to
  1295.                       define each item in that menu.  
  1296.  
  1297.                       You  must  specify  the item label and the command to
  1298.                       be  executed when the menu item is selected. Refer to
  1299.                       the  DefineFunction command for an explanation of the
  1300.                       valid   options.   The  DefineFunction  section  also
  1301.  
  1302.  
  1303.                                PowerPlatform 1.0                    Page 22
  1304.  
  1305.  
  1306.                       discusses   how  to  format  the  command  line.  The
  1307.                       DefineItem  command  line is the same except that you
  1308.                       cannot  specify  the  PowerPlatform place markers. No
  1309.                       selected  files  are passed to commands executed from
  1310.                       the menu bar.  
  1311.  
  1312.                       The  one  option  not  covered  in the DefineFunction
  1313.                       discussion.  is  the  Key=  option. You can specify a
  1314.                       standard  Amiga  command key alternative for the menu
  1315.                       item.  For  example  if  you specified Key=A then you
  1316.                       could  execute  the  command  by  pressing  the right
  1317.                       Amiga   and  A  keys  together.  Consult  your  Amiga
  1318.                       documentation for more information.  
  1319.  
  1320.  
  1321.      DefineMenu       [menu label] 
  1322.  
  1323.                       PowerPlatform  allows  you  to  specify five menus to
  1324.                       add  to  the  existing  PowerPlatform  menu  bar. You
  1325.                       start  by  using the DefineMenu command to define the
  1326.                       new  menu and follow that with DefineItem commands to
  1327.                       define each item in that menu.  
  1328.  
  1329.                       You must specify the menu label.  
  1330.  
  1331.                       You  can  define  menus  in  your profile only. Menus
  1332.                       cannot be redefined.  
  1333.  
  1334.  
  1335.      DisplayBeep 
  1336.  
  1337.                       The  DisplayBeep  command  will  flash the screen. It
  1338.                       can  be  used  at  any  time but normally it would be
  1339.                       used to signal an error or exceptional condition.  
  1340.  
  1341.  
  1342.      Message          [message text] 
  1343.  
  1344.                       This  command  is  used  from within an ARexx EXEC to
  1345.                       display  a  message.  If  the  EXEC  is  running in a
  1346.                       console  window  then  you  can obviously display the
  1347.                       message  there  using the standard ARexx say command.
  1348.                       But  if  you have no console you can use this command
  1349.                       to  display  a  one line message in the PowerPlatform
  1350.                       title  bar.  You  can  use  the  Beep and DisplayBeep
  1351.                       commands,  if  required,  to  draw  attention  to the
  1352.                       message.  
  1353.  
  1354.  
  1355.      Options          {Name Time MM/DD/YY DD/MM/YY YY/MM/DD _B_y_t_e_s Blocks} 
  1356.                       { _W_o_r_k_B_e_n_c_h HiRes Interlace} 
  1357.  
  1358.                       The  first  set  of options control the PowerPlatform
  1359.                       directory  display. By default PowerPlatform displays
  1360.                       the  file  name  followed  by the file size in bytes.
  1361.                       You   can  change  it  to  the  file  creation  date,
  1362.                       creation time, size in blocks or name only.  
  1363.  
  1364.  
  1365.                                PowerPlatform 1.0                    Page 23
  1366.  
  1367.  
  1368.                       The    second    group   of   options   control   how
  1369.                       PowerPlatform  opens  it's  window.   If workbench is
  1370.                       specified  PowerPlatform opens a full sized window on
  1371.                       a  HiRes  WorkBench  or  a  half  height window on an
  1372.                       interlaced WorkBench.  
  1373.  
  1374.                       If  you  specify  HiRes,  PowerPlatform opens a Hires
  1375.                       custom  screen.  Interlace instructs PowerPlatform to
  1376.                       open an interlaced custom screen.  
  1377.  
  1378.  
  1379.      QueryPort 
  1380.  
  1381.                       PowerPlatform  opens  an  ARexx  port  called APP<n>,
  1382.                       where  <n>  is the PowerPlatform iteration number. If
  1383.                       you  are  only  running  PowerPlatform  once the port
  1384.                       name  is  APP1,  the  second  time it is invoked it's
  1385.                       APP2  etc.  If you ever need to know the current port
  1386.                       name in an ARexx EXEC you can use this command.  
  1387.  
  1388.                       You  must  specify  the ARexx options results command
  1389.                       as  PowerPlatform  returns  the port name as a result
  1390.                       string.   See   your  ARexx  documentation  for  more
  1391.                       information.  
  1392.  
  1393.  
  1394.      QuerySource 
  1395.  
  1396.                       Use   this   command   to   find   out   the  current
  1397.                       PowerPlatform  source  directory.   You can often get
  1398.                       this  by  stripping  of  the  path  from any filename
  1399.                       passed  to  the  EXEC.  You can use this command when
  1400.                       there was no file name passed.  
  1401.  
  1402.                       You  must  specify  the ARexx options results command
  1403.                       as  PowerPlatform  returns  the source directory as a
  1404.                       result  string.   See  your  ARexx  documentation for
  1405.                       more information.  
  1406.  
  1407.  
  1408.      QueryTarget 
  1409.  
  1410.                       Use   this   command   to   find   out   the  current
  1411.                       PowerPlatform  target  directory.   You can often get
  1412.                       this  by  stripping  of  the  path  from any filename
  1413.                       passed  to  the  EXEC.  You can use this command when
  1414.                       there was no command name passed.  
  1415.  
  1416.                       You  must  specify  the ARexx options results command
  1417.                       as  PowerPlatform  returns  the target directory as a
  1418.                       result  string.   See  your  ARexx  documentation for
  1419.                       more information.  
  1420.  
  1421.  
  1422.      ReDrawFunctions 
  1423.  
  1424.                       This  command  will  redraw all the function buttons.
  1425.  
  1426.  
  1427.                                PowerPlatform 1.0                    Page 24
  1428.  
  1429.  
  1430.                       It  is  designed to be used when you are changing the
  1431.                       function  button  definitions. PowerPlatform does not
  1432.                       redraw  the buttons as you define them. Once you have
  1433.                       defined  all  your buttons issue this command once to
  1434.                       refresh the display.  
  1435.  
  1436.  
  1437.      Reset 
  1438.  
  1439.                       This  command  will  deselect  any  selected files or
  1440.                       subdirectories in the active directory.  
  1441.  
  1442.  
  1443.      TagAll 
  1444.  
  1445.                       If  the source directory is active the TagAll command
  1446.                       will   select   all   the  files  and  subdirectories
  1447.                       displayed.  This  command has no effect if the target
  1448.                       directory is active.  
  1449.  
  1450.  
  1451.  
  1452.  
  1453.  
  1454.  
  1455.  
  1456.  
  1457.  
  1458.  
  1459.  
  1460.  
  1461.  
  1462.  
  1463.  
  1464.  
  1465.  
  1466.  
  1467.  
  1468.  
  1469.  
  1470.  
  1471.  
  1472.  
  1473.  
  1474.  
  1475.  
  1476.  
  1477.  
  1478.  
  1479.  
  1480.  
  1481.  
  1482.  
  1483.  
  1484.  
  1485.  
  1486.  
  1487.  
  1488.  
  1489.                                PowerPlatform 1.0                    Page 25
  1490.  
  1491.  
  1492.      __PP__oo__ww__ee__rr__PP__ll__aa__tt__ff__oo__rr__mm____RR__ee__gg__ii__ss__tt__rr__aa__tt__ii__oo__nn 
  1493.  
  1494.           PowerPlatform is  not  free,  it  is  shareware. You may use this
  1495.      version  of  the  program  for  30  days. After the 30 days you should
  1496.      either delete it or register it.  
  1497.  
  1498.           Registration is  just $25. When you register you will receive the
  1499.      latest  version  on  the  program on disk. The only difference between
  1500.      the  registered  and  shareware  versions is that you will not see the
  1501.      shareware  requester when PowerPlatform starts up using the registered
  1502.      version.  
  1503.  
  1504.           PowerPlatform is  fully  supported  and  will  be  enhanced  on a
  1505.      regular  basis.   As  a  registered  user  you will be notified of new
  1506.      versions  of the program.  Please register PowerPlatform and support a
  1507.      unique   software   distribution  method.  How  many  times  have  you
  1508.      purchased  commercial  software  and then left it sitting on the shelf
  1509.      because  it did not meet your needs or did not function as advertised.
  1510.      You  can  try  out PowerPlatform free for 30 days and without any kind
  1511.      of  obligation.  If  you don't like it dump it. If you continue to use
  1512.      it,  please  register it by filling out the following form and mailing
  1513.      it with your check.  
  1514.  
  1515.  
  1516.  
  1517.  
  1518.  
  1519.  
  1520.  
  1521.  
  1522.  
  1523.  
  1524.  
  1525.  
  1526.  
  1527.  
  1528.  
  1529.  
  1530.  
  1531.  
  1532.  
  1533.  
  1534.  
  1535.  
  1536.  
  1537.  
  1538.  
  1539.  
  1540.  
  1541.  
  1542.  
  1543.  
  1544.  
  1545.  
  1546.  
  1547.  
  1548.  
  1549.  
  1550.  
  1551.                                PowerPlatform 1.0                    Page 26
  1552.  
  1553.  
  1554.      Mail to:  Martin C. Warnett
  1555.                2407 25th Avenue
  1556.                San Francisco
  1557.                CA 94116.
  1558.  
  1559.  
  1560.  
  1561.      Name:    _______________________________________________________________
  1562.  
  1563.  
  1564.      Street:  _______________________________________________________________
  1565.  
  1566.  
  1567.      City:    __________________________________   State:__   Zip: _____-____
  1568.  
  1569.  
  1570.      Country: __________________________________
  1571.  
  1572.  
  1573.  
  1574.  
  1575.      Number of Copies: ___ at $25 each (U.S. Funds)           Total $___.__
  1576.  
  1577.  
  1578.  
  1579.      BIX User ID:      ____________________  (Optional)
  1580.  
  1581.  
  1582.      Compuserve ID:    ____________________  (Optional)
  1583.  
  1584.  
  1585.  
  1586.      If you prefer I can send you your registered copy of PowerPlatform via
  1587.      BIX mail. (BIX subscribers only, not available via Compuserve). Be sure
  1588.      to include you BIX ID above and check below.
  1589.  
  1590.  
  1591.  
  1592.      _____ YES, please send my registered copy via BIX mail.
  1593.  
  1594.  
  1595.  
  1596.  
  1597.  
  1598.  
  1599.  
  1600.  
  1601.  
  1602.  
  1603.  
  1604.  
  1605.  
  1606.  
  1607.  
  1608.  
  1609.  
  1610.  
  1611.  
  1612.  
  1613.      
  1614.  
  1615.  
  1616.                                Table of Contents
  1617.  
  1618.  
  1619.         Introduction.................................................    2
  1620.         PowerPlatform Installation...................................    3
  1621.         Using PowerPlatform..........................................    4
  1622.            PowerPlatform Directory and Function Areas................    4
  1623.            The PowerPlatform Disk Information Area...................    6
  1624.            The PowerPlatform Menu Bar................................    7
  1625.         PowerPlatform Configuration..................................    8
  1626.         Advanced PowerPlatform Configuration.........................   13
  1627.         Writing your own PowerPlatform EXEC's........................   14
  1628.         PowerPlatform Command Reference..............................   15
  1629.            Beep......................................................   16
  1630.            CDSource..................................................   16
  1631.            CDTarget..................................................   16
  1632.            ClearFunctions............................................   16
  1633.            DefineColor...............................................   17
  1634.            DefineConsole.............................................   17
  1635.            DefineDevice..............................................   17
  1636.            DefineExt.................................................   18
  1637.            DefineFunction............................................   18
  1638.            DefineItem................................................   21
  1639.            DefineMenu................................................   22
  1640.            DisplayBeep...............................................   22
  1641.            Message...................................................   22
  1642.            Options...................................................   22
  1643.            QueryPort.................................................   23
  1644.            QuerySource...............................................   23
  1645.            QueryTarget...............................................   23
  1646.            ReDrawFunctions...........................................   23
  1647.            Reset.....................................................   24
  1648.            TagAll....................................................   24
  1649.         PowerPlatform Registration...................................   25
  1650.  
  1651.  
  1652.  
  1653.  
  1654.  
  1655.  
  1656.  
  1657.  
  1658.  
  1659.  
  1660.  
  1661.  
  1662.  
  1663.  
  1664.  
  1665.  
  1666.  
  1667.  
  1668.  
  1669.  
  1670.  
  1671.  
  1672.  
  1673.  
  1674.  
  1675.  
  1676.